docs: move documentation to inline comments: GtkColorButton

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 83501438ff6a2d4a2689650777396870dd0397b2..28b7b357be5602a35f1257cc6c07c3b681f53edd 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -8,6 +8,7 @@ gtkbuilder.sgml
 gtkbutton.sgml
 gtkcalendar.sgml
 gtkcelleditable.sgml
+gtkcolorbutton.sgml
 gtkcombobox.sgml
 gtkcomboboxentry.sgml
 gtkcontainer.sgml

diff --git a/docs/reference/gtk/tmpl/gtkcolorbutton.sgml b/docs/reference/gtk/tmpl/gtkcolorbutton.sgml
deleted file mode 100644 (file)
index f51aeca..0000000
--- a/docs/reference/gtk/tmpl/gtkcolorbutton.sgml
+++ /dev/null
@@ -1,148 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkColorButton
-
-<!-- ##### SECTION Short_Description ##### -->
-A button to launch a color selection dialog
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkColorButton is a button which displays the currently selected color 
-an allows to open a color selection dialog to change the color. It is suitable 
-widget for selecting a color in a preference dialog.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-#GtkColorSelectionDialog, #GtkFontButton
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkColorButton ##### -->
-<para>
-The GtkColorButton struct has only private fields and 
-should not be used directly.
-</para>
-
-
-<!-- ##### SIGNAL GtkColorButton::color-set ##### -->
-<para>
-
-</para>
-
-@colorbutton: the object which received the signal.
-
-<!-- ##### ARG GtkColorButton:alpha ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:use-alpha ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_color_button_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_button_new_with_color ##### -->
-<para>
-
-</para>
-
-@color: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_button_set_color ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_button_get_color ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_button_set_alpha ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@alpha: 
-
-
-<!-- ##### FUNCTION gtk_color_button_get_alpha ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_button_set_use_alpha ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@use_alpha: 
-
-
-<!-- ##### FUNCTION gtk_color_button_get_use_alpha ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_button_set_title ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@title: 
-
-
-<!-- ##### FUNCTION gtk_color_button_get_title ##### -->
-<para>
-
-</para>
-
-@color_button: 
-@Returns: 
-
-

diff --git a/gtk/gtkcolorbutton.c b/gtk/gtkcolorbutton.c
index 2e2214f85b3330d332821c56d216f5f09ba0020c..c363f3aa26971b6e1e503d28944dd0b8c470e8ed 100644 (file)
--- a/gtk/gtkcolorbutton.c
+++ b/gtk/gtkcolorbutton.c
@@ -45,6 +45,19 @@
 #include "gtkprivate.h"
 #include "gtkintl.h"
 
+
+/**
+ * SECTION:gtkcolorbutton
+ * @Short_description: A button to launch a color selection dialog
+ * @Title: GtkColorButton
+ * @See_also: #GtkColorSelectionDialog, #GtkFontButton
+ *
+ * The #GtkColorButton is a button which displays the currently selected color
+ * an allows to open a color selection dialog to change the color. It is suitable
+ * widget for selecting a color in a preference dialog.
+ */
+
+
 /* Size of checks and gray levels for alpha compositing checkerboard */
 #define CHECK_SIZE  4
 #define CHECK_DARK  (1.0 / 3.0)